home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 25 / Cream of the Crop 25.iso / os2 / hrun102.zip / HOMERUN.TXT < prev    next >
Text File  |  1997-03-17  |  8KB  |  180 lines
  1.  
  2.                               HOMERUN V1.02 GENERAL HELP
  3.  
  4.  Index
  5.  
  6.         1.0         Introduction
  7.         2.0         Installation
  8.         3.0         Scheduling Program Starts & Kills
  9.              3.1    Start-ups
  10.              3.2    Kills
  11.         4.0         Appointment/Message Daily Diary
  12.         5.0         Calendar
  13.         6.0         Disclaimer
  14.         7.0         Bugs and Suggestions
  15.  
  16.  1.0 Introduction
  17.  
  18.  Homerun allows programs to be run on any time schedule.
  19.  Homerun can start & terminate OS2, Dos and WinOS2 (Windows)
  20.  programs in a window, fullscreen or Presentation Manager as
  21.  applicable. Dos & OS2 windows can also be closed using hexadecimal
  22.  commands. Convenient red/green buttons confirm whether the
  23.  start-ups and kills are active or inactive.
  24.  If you have installed any OS2 FixPaks after Warp 3 it is recommended
  25.  that you read the file rexxsom.txt included in the Homerun directory.
  26.  The appointment/message scheduler allows simple multiple scheduling,
  27.  and has a programmable warning alarm.
  28.  
  29.  2.0 Installation
  30.  
  31.  Homerun can be installed from its own directory or from a floppy
  32.  drive.  The installation program will install an icon on the desktop.
  33.  To install from its own directory unzip the files into a directory of
  34.  choice (default is C:\HOMERUN), and at the C:\HOMERUN>
  35.  prompt type INSTALL.
  36.  To install from a floppy, at the A:> prompt type INSTALL.
  37.  Homerun requires the runtime library file VROBJ.DLL and it is in
  38.  the hrun100.zip file.  If you already have VROBJ.DLL installed, you
  39.  do not need this file. VROBJ.DLL can remain in the Homerun
  40.  directory or can be moved to a directory listed in the LIBPATH list
  41.  defined in the configuration file config.sys.
  42.  
  43.  To minimize CPU time, Homerun only status checks every 20 seconds.
  44.  Between these checks there is no demand on the CPU. If you are
  45.  watching, this delay can sometimes give the impression of being slow
  46.  to respond to changes. Just remember, we are saving resources!
  47.  
  48.  In 'Settings' there is a preferences file which can remove some of the
  49.  pop-up boxes for the experienced user.
  50.  
  51.  Note: A 'System Proportional Italic' font is used in Homerun to
  52.  distinguish inputted data. In one test computer at 1024x768 there were
  53.  slight imperfections in the appearance of the font. I have stuck with
  54.  the italic font, but please let me know if there are other systems
  55.  with this problem, and I will change the font back to a normal font.
  56.  
  57.  3.0 Scheduling Program Starts & Kills
  58.  
  59.  3.1 Start-ups
  60.  
  61.  Click on 'Events' in the 'Schedule' drop down menu. There are hints
  62.  shown at the bottom of most windows to assist in entering data.
  63.  
  64.  There is virtually no limitation on how you can set up the start-ups.
  65.  For OS2 programs, It is best to start with the 'Default' setting and to
  66.  test your choice by clicking on 'Run now' and then 'Terminate now'
  67.  if you are using this feature. It is unlikely that incorrect set-up of a
  68.  program will crash the program, but in some cases the program may
  69.  not run as scheduled. It is wise to test the start-up by clicking the
  70.  'Run now' button before saving it to the container list.
  71.  
  72.  DO NOT run Dos and Windows programs with the 'Default' setting.
  73.  Although they may generally run, Homerun does not keep track of
  74.  the session PID number and can not terminate it.
  75.  
  76.  The file extension must be included in order for the search check to
  77.  work properly although the 'Terminate after X minutes' will still work
  78.  properly. For 'Dos Window' and 'Dos Fullscreen' applications (including
  79.  WinOS2 applications started in dos, the 'Terminate after X minutes'
  80.  option, keeps track of the start-up PID number and uses that that to
  81.  terminate the program. If several programs are started at the exact
  82.  same time, Homerun could grab the wrong PID number, so it is best to
  83.  stagger Dos start-ups by at least a minute.
  84.  
  85.  Windows programs may only run in full screen and are tricky.  Success
  86.  in making windows programs run depends on the video resolution and
  87.  other factors. Also, you should enter the directory that is the working
  88.  directory for the program you are running. For example enter:
  89.  
  90.            Entry Title:                             Windows Eudora
  91.            Program path & file name:         eudora.exe
  92.            Parameters:                             
  93.            Directory:                                c:\eudora
  94.  
  95.  to run Eudora. The 'Run in a WinOS2 Window session' only runs if the
  96.  video resolution is 640x480. 
  97.  
  98.  Terminating of windows programs is not supported, other than you
  99.  can terminate a windows program YOU start through Dos. Although
  100.  if you were able to send a hexadecimal 'ALT-F' and 'x' via the 'Use
  101.  macro' you would think it should work.
  102.  
  103.  Hints:
  104.  1. If you intend to start-up a 'Run in a WinOS2 Fullscreen session' while
  105.     you have a 'Dos Fullscreen' session active, the Dos session should be
  106.     started in the background or questionable results may occur.
  107.  2. OS2 Windows do not start in the 'Background'. Use the 'Min' box and
  108.     start minimized.
  109.  3. Fullscreen programs do not start minimized. Use the 'Background'
  110.     box and start in the background.
  111.  4. Thanks to Andy Glass who offered that:
  112.                     cmd.exe /c detatch [path]/homerun.exe
  113.     will run Homerun in 4OS2.
  114.  
  115.  3.2 Kills
  116.  
  117.  The 'kills' use a program called 'go' written by Carston Wimmer, and
  118.  further information about this program can be found in the file go.doc.
  119.  You can send keystroke commands and hexadecimal keystrokes to a
  120.  Dos or OS2 window by activating the 'Use macro' button and
  121.  completing the entry fields. For example enter:
  122.  
  123.            Window Title:                DOS Window
  124.            Macro:                          exit
  125.  
  126.  to close a dos window.
  127.         Note: This feature uses the clipboard and it must be active.
  128.  
  129.  The 'Program started in an OS2 Window' check box is to be used for
  130.  programs started in an OS2 Window or started with a .cmd batch file.
  131.  For example, Maximus could be started with a batch file 'max.cmd'.
  132.  In this case the executable to be entered would be the Maximus 
  133.  'maxp.exe' file and the 'Program started in an OS2 Window' box
  134.  should be checked in order that the OS2 window is closed at the 
  135.  termination of (maxp.exe) Maximus.
  136.  
  137.  You can enter a sequence of kills through the start-ups if desired,
  138.  using 'go' or any other kill program.  For example enter:
  139.  
  140.            Entry Title:                             Elephant
  141.            Program path & file name:        go k
  142.            Parameters:                            elephant.exe
  143.            Directory:                               c:\homerun
  144.  
  145.       ( Hint: In this example use 'Run without using start' as the shell.)
  146.  
  147.  to kill a program whose executable is 'elephant.exe'. The Directory is
  148.  the path to your 'kill' program.
  149.  
  150.  The 'Fullscreen (Window) Cmd.exe Shell and kill on exit' do not use the
  151.  /C of START which is not too reliable. Rather the program 'kills' the shell
  152.  after the program is found and killed.
  153.  
  154.  4.0 Appointment/Message Daily Diary
  155.  
  156.  The appointment/message scheduler is quite straight forward and
  157.  contains hints in the windows to assist the new user.  There is a
  158.  programmable appointment warning alarm to alert the user about
  159.  impending appointments. The appointments can be scheduled in a
  160.  variety of ways from every few minutes to yearly and beyond.
  161.  
  162.  5.0 Calendar
  163.  
  164.  There is a built in 50+ year calendar and access to this feature has been
  165.  conveniently located in the Calendar menu.
  166.  
  167.  6.0 Disclaimer
  168.  
  169.  The author makes no representations about the accuracy or suitability
  170.  of this material for any purpose.  It is provided "as is", without any
  171.  express or implied warranties.  The author will assume no liability for
  172.  damages either from the direct use of this product or as a consequence
  173.  of the use of this product.
  174.  
  175.  7.0 Bugs and Suggestions
  176.  
  177.  Should an unexpected dump occur, check the Homerun.err file for an
  178.  explanation. Please report any bugs (or suggestions) and I will take
  179.  action on them if possible and practical.
  180.